home *** CD-ROM | disk | FTP | other *** search
/ Aminet 6 / Aminet 6 - June 1995.iso / Aminet / util / misc / CheckDate120.lha / CheckDate.doc next >
Encoding:
Text File  |  1995-02-28  |  3.1 KB  |  143 lines
  1. Document CheckDate Documentation
  2.  
  3.                  CheckDate Documentation
  4.                 ~~~~~~~~~~~~~~~~~~~~~~~~~
  5.  
  6.          Version 1.20  ©'95 SiliconSurfer/Phantasm
  7.  
  8.              Another PHANTASM FREEWARE program
  9.  
  10.  
  11.  
  12. 0. Short Description
  13. ====================
  14.  
  15. Checkdate examines the dates of all files in any .LZX, .LHA or .LZH archive.
  16. The newest and oldest dates are output together with their filenames and
  17. the name of the archive. The output can be redirected into a file for later
  18. analysis.
  19. Checkdate is useful for sysops who like to fake old stuff, or for traders,
  20. who wants to know the real age of an archive.
  21.  
  22.  
  23. 1. Syntax & Output
  24. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  25.  
  26. The AmigaDOS commandline options:
  27.  
  28. CheckDate FILE/A,FIRST/K/N,LAST/K/N,CHECK/K,ALL/S
  29.  
  30.  
  31. You can use AmigaDOS wildcards within the filename.
  32.  
  33.  
  34.  
  35. 1.1. The options
  36. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  37.  
  38. FILE <archive>
  39.  
  40.     The name of the archive to examine. Works with AmigaDOS wildcards.
  41.     Example: (#?.lzx|#?.lha|#?.lzh)
  42.  
  43.  
  44. FIRST <n>
  45.  
  46.     The oldest n files are output with date and name.
  47.     If these files belong to the newest ones yet, they are not output
  48.         a second time.
  49.     Default is 0.
  50.  
  51.  
  52. LAST <n>
  53.  
  54.     The newest n files are output with date and name.
  55.     Default is 3.
  56.  
  57.  
  58. CHECK <date>
  59.  
  60.     The date of the newest file will be compared with the given date.
  61.     If the file is older then <date> the returncode will be set to
  62.         RETURN_WARN (=5) and the text "puuuuhhhh... this stuff is too old !"
  63.         will be output.
  64.         Else the returncode will be set to RETURN_OK (=0).
  65.  
  66.     The format of <date> is the local format.
  67.     German format:   DD-MON-YY or "DD-MON-YY HH:MM:SS"
  68.     German example:  03-Feb-94 or "03-Feb-94 16:08:53"
  69.  
  70.  
  71. ALL
  72.  
  73.     If wildcards are used within the name of the archive, Checkdate
  74.         works recursive, means all subdirectories are searched for the
  75.         pattern, too.
  76.     Example: "CheckDate (#?.lzx|#?.lzh|#?.lha) df0: ALL" searches whole
  77.     df0: for files with the ending .lzx, .lzh and .lha and processes them.
  78.  
  79.  
  80.  
  81.  
  82. 1.2. An example
  83. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  84.  
  85. e.g.: CheckDate abc.lha FIRST 3 LAST 3
  86.  
  87. The output looks like this:
  88.  
  89.  
  90. CheckDate V1.20 (Feb 28 1995)  ©'95 by SiliconSurfer/Phantasm
  91.  
  92. ---------  abc.lha [21-Apr-94] ---------
  93. -NEWEST -
  94. 29-Mar-94  x1
  95. 22-Mar-94  x1.info
  96. 22-Mar-94  Callx1
  97. -OLDEST -
  98. 28-Mar-93  1.dat
  99. 25-Jul-93  2.dat
  100. 19-Sep-93  3.dat
  101.  
  102.  
  103. The first 3 filenames are the 3 with the newest date.
  104. Below them you see the 3 oldest files in that archive.
  105.  
  106.  
  107.  
  108. 2. How Checkdate works
  109. ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
  110. LHA resp. LZX are called, with output redirection to T:chkdate.
  111. Thereafter T:chkdate will be processed and deleted.
  112. The processing of FILE_ID.DIZ will be skipped (for purpose).
  113.  
  114. The call of LHA looks like this: LHA >T:chkdate v "archive"
  115. The call of LZX looks like this: LZX >T:chkdate l "archive"
  116.  
  117.  
  118.  
  119. 3. Last words
  120. ¯¯¯¯¯¯¯¯¯¯¯¯¯
  121. This whole archive is absolutely FREEWARE. You can do anything you want
  122. with it.
  123.  
  124. This program has been tested by several people.
  125.  
  126.  
  127.  
  128. Voice:    +49-40-7216995 (Germany)
  129. Email:    SILICONSURFER@Blackbox.shnet.org
  130.           SILICONSURFER@Dame.shnet.org
  131.  
  132. Address:
  133.           Tim Ruehsen
  134.           Joh.-Rabe-Stieg 8
  135.           21033 Hamburg
  136.           GERMANY
  137.  
  138.  
  139. Please send me email, if you use this program !
  140.  
  141.  
  142. FF - Fiel Fun.
  143.